package edu.ptu.shortlink.project.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import edu.ptu.shortlink.project.dto.req.ShortLinkGroupStatsAccessRecordReqDTO;
import edu.ptu.shortlink.project.dto.req.ShortLinkGroupStatsReqDTO;
import edu.ptu.shortlink.project.dto.req.ShortLinkStatsAccessRecordReqDTO;
import edu.ptu.shortlink.project.dto.req.ShortLinkStatsReqDTO;
import edu.ptu.shortlink.project.dto.resp.ShortLinkStatsAccessRecordRespDTO;
import edu.ptu.shortlink.project.dto.resp.ShortLinkStatsRespDTO;

/**
 * @BelongsProject: shortlink
 * @BelongsPackage: edu.ptu.shortlink.project.service
 * @Author: HYJ
 * @CreateTime: 2025-05-08  19:43
 * @Description: 短链接监控服务层
 * @Version: 1.0
 */
public interface IShortLinkStatsService {
    /**
     * 短链接监控
     *
     * @param requestParam 请求参数
     * @return 短链接监控结果
     */
    ShortLinkStatsRespDTO oneShortLinkStats(ShortLinkStatsReqDTO requestParam);

    /**
     * 短链接访问统计访问记录
     *
     * @param requestParam 请求参数
     * @return 短链接访问统计访问记录
     */
    IPage<ShortLinkStatsAccessRecordRespDTO> shortLinkStatsAccessRecord(ShortLinkStatsAccessRecordReqDTO requestParam);

    /**
     * 分组短链接监控
     *
     * @param requestParam 请求参数
     * @return 分组短链接监控结果
     */
    ShortLinkStatsRespDTO groupShortLinkStats(ShortLinkGroupStatsReqDTO requestParam);

    /**
     * 分组短链接访问统计访问记录
     *
     * @param requestParam 请求参数
     * @return 分组短链接访问统计访问记录
     */
    IPage<ShortLinkStatsAccessRecordRespDTO> groupShortLinkStatsAccessRecord(ShortLinkGroupStatsAccessRecordReqDTO requestParam);
}
